home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / BBS-Archive / Comm / AmiTCP30b2.lha / HowToInstall < prev    next >
Text File  |  1994-05-03  |  9KB  |  223 lines
  1. * How to Install AmiTCP/IP:
  2.  
  3.   You should not install the current version on top of older
  4.   version.  If your disk space allows, leave the old version on the
  5.   disk and delete it when you have the new version up and running. The
  6.   installation script will copy your old configuration from old
  7.   version directory.
  8.   
  9.   Extract first the distribution archives (AmiTCP_xxx_xx.lha) to some
  10.   directory in your hard disk (e.g. WORK:).
  11.  
  12. * Configuration Information
  13.   
  14.   Before you proceed, you should get the following information from
  15.   your network administration (if you don't have the information, you
  16.   have to reinstall AmiTCP/IP afterwards):
  17.   
  18.   * Internet protocol address for your computer. This is a 32 bit
  19.     integer represented as a series of decimal numbers separated by
  20.     dots. For example, 130.233.161.40 is a legal internet address.
  21.  
  22.   * If you have a point-to-point connection to the network, you need
  23.     to know your destination IP address, that is the IP address of
  24.     the host you are connected. SLIP, CSLIP and PPP are examples of
  25.     point-to-point connections.
  26.   
  27.   * Netmask for your network. This specifies how many bits of your
  28.     internet address are used to specify the network address. Netmask
  29.     is like 255.255.255.0. If your network is not sub-netted, then do
  30.     not have to supply this value (a default computed from the IP
  31.     address is used).
  32.   
  33.   * Address of the default gateway. If your host do not know any route
  34.     to a host it resorts to the default gateway. If you have only one
  35.     point-to-point connection, you should use the host you are
  36.     connected as a default gateway.
  37.   
  38.   * Your host name. Host name is a more convenient way than the internet
  39.     address to refer your computer. This is like `Amiga1'.
  40.   
  41.   * Domain name of your site. For example, "hut.fi" is the domain name
  42.     for the Helsinki University of Technology in Finland. The part
  43.     after the first dot in your full host name is usually (but not
  44.     always) your domain name.
  45.   
  46.   * Addresses of the Domain Name Servers which will be used to
  47.     translate host names to the corresponding internet addresses. A
  48.     local database must be used instead if there is no name server on
  49.     your domain.
  50.   
  51.     If you have an access to a Unix machine in your network, you can
  52.     probably find a list of domains and name server addresses in the
  53.     file `/etc/resolv.conf'. Also, if there is no name server, you can
  54.     copy the file `/etc/hosts' to the `AmiTCP:db/hosts'.
  55.  
  56.   Next you should obtain a SANA-II compatible device driver for your
  57.   network adapter. The SANA-II drivers are usually installed into
  58.   directory `DEVS:networks'. We have included a few freely
  59.   distributable drivers with the AmiTCP/IP. You can use the SLIP or
  60.   CSLIP drivers with a serial interface.
  61.  
  62.   AmiTCP/IP uses a mnemonic name of SANA-II device driver to access
  63.   it. The name and parameter mapping is specified in the configuration
  64.   file db/interfaces. You should also know the number of unit you are
  65.   using (usually 0). You might also have to make a configuration file
  66.   for your device driver. The configuration files have usually the
  67.   name of the interface appended with unit number and `.config', e.g.
  68.   unit 1 of rhslip.device uses the configuration file `slip1.config'.
  69.   Configuration files are usually stored into the directory
  70.   `ENV:Sana2/'. See the example configuration file for the slip.device
  71.   unit 0 at the end of this file.
  72.   
  73.   You may start the installation by double-clicking the
  74.   "Install_AmiTCP"-icon.
  75.   
  76.   If you use slip.device or cslip.device SANA-II drivers, you _must_
  77.   edit the configuration files before starting AmiTCP.
  78.  
  79. * About User and Group Databases
  80.  
  81.   AmiTCP/IP gives some user management support. For each user, there
  82.   is one line of information in the file AmiTCP:db/passwd, which is
  83.   currently used by `finger' and `ls' commands.  This line is
  84.   separated to 7 parts with vertical bars (`|'):
  85.  
  86. username|password|uid|gid|gecos|home directory|shell
  87.  
  88.   The `gecos' part contains real name, office, office phone and home
  89.   phome numbers separated with commas (',').  You can print them with
  90.   finger. Markus Peuhkuri has following entry in the example `passwd'
  91.   file:
  92.  
  93. puhuri|*|17681|100|Markus Peuhkuri,G218,4512462,4521992|users:puhuri|shell
  94.  
  95.   Markus has username puhuri. As the password field contains `*', his
  96.   password is disabled (so he can not log into your machine even if
  97.   the remote login is installed). His numeric identifier, UID, is
  98.   17681, and his default group number, GID, is 100, `users'. The UID
  99.   and GID must be numbers between 0 - 65535. After his real name there
  100.   is his office room at HUT, is work phone and his home phone.  His
  101.   home directory is `users:puhuri', finger searches his `.plan' and
  102.   `.project' files from that directory. Last field is his login shell,
  103.   AmiTCP/IP does not currently use that for anything.
  104.  
  105.   You can add and remove users simply editing your `passwd' file with
  106.   text editors (Emacs, Ed, Edit). Make sure that finger can parse the
  107.   changed file and finger each user that you have changed.
  108.  
  109.   The passwd file format is mostly compatible with MultiUser by Geert
  110.   Uytterhoeven and with AS225r2 beta from Commodore. You can use `ls'
  111.   with MultiUser or other filesystems which have WB3.0 compatible
  112.   interface. If you are using MultiUser, you should copy or link your
  113.   MultiUser passwd file to AmiTCP:db/passwd (install script tries to
  114.   copy automatically, but it does not have enough intelligence to do
  115.   it always right).
  116.  
  117.   The group file, `AmiTCP:db/group' has similar format. There is more
  118.   information about group and password files in AutoDoc file
  119.   AmiTCP:db/doc/netlib.doc.
  120.  
  121. * If There Is Some Problems with Installation 
  122.   
  123.   Here is an example of the required information:
  124.  
  125.     Name of your computer:             slip-2
  126.     Your domain part:             hut.fi
  127.     Aliases for it:             amy
  128.     Your Internet address:             130.233.161.50
  129.     Destination address (terminal server):    130.233.161.90
  130.     Netmask of used in your network:    255.255.252.0
  131.     Address of the default gateway:     130.233.163.254
  132.     Domain names to search:            hut.fi
  133.                         cs.hut.fi
  134.     Addresses of nameservers:         130.233.224.1
  135.                         130.233.224.13  
  136.                         128.214.4.29
  137.     SANA-II device driver:             slip.device 
  138.         (Serial Line IP)
  139.     Unit of the SANA-II device driver:     0 
  140.     Name of the interface (db/interfaces):    slip0
  141.    
  142.   `AmiTCP:bin/StartNet' (lines beginning with `;' are comments):
  143.  
  144.     run AmiTCP:AmiTCP
  145.     SYS:Rexxc/WaitForPort AMITCP
  146.     ; configure loop-back device
  147.     AmiTCP:bin/ifconfig lo0 localhost
  148.     ; Configure slip0
  149.     AmiTCP:bin/ifconfig slip0 130.233.161.50 +
  150.     130.233.161.90 netmask 255.255.252.0
  151.     ; Add route to this host
  152.     AmiTCP:bin/route add slip-2.hut.fi localhost
  153.     ; Add route to the default gateway
  154.     AmiTCP:bin/route add default 130.233.163.254
  155.     ; Start the internet `super server'
  156.     run AmiTCP:bin/inetd
  157.  
  158.   `Amitcp:db/netdb-myhost' (lines beginning with `;' are comments):
  159.  
  160.     ; This host
  161.     HOST 130.233.161.50 slip-2.hut.fi slip-2 amy
  162.     ; Domain names
  163.     DOMAIN hut.fi
  164.     DOMAIN cs.hut.fi
  165.     ; Name servers
  166.     NAMESERVER 130.233.224.1
  167.     NAMESERVER 130.233.224.13
  168.     NAMESERVER 128.214.4.29
  169.  
  170.   `S:User-Startup' will contain something along following lines (if
  171.   you do not choose to start AmiTCP at the system startup):
  172.   
  173.     ;BEGIN AmiTCP/IP
  174.     setenv HOSTNAME slip-2.hut.fi
  175.     assign AmiTCP: Work:AmiTCP-x.x
  176.     path AmiTCP:bin add
  177.     ;END AmiTCP/IP
  178.  
  179.   Example of ENV:sana2/slip0.config:
  180.  
  181.     serial.device 0 19200 130.233.161.50
  182.  
  183.   Note that the baud rate must match the baud rate of the terminal
  184.   program used for dialing!
  185.  
  186. * What Happens in the Installation?
  187.   
  188.   The course of installation is shortly explained for those of you who
  189.   want to know what happens to their computer:
  190.  
  191.   * Amount of free memory and version of system software is checked
  192.   * Destination directory is asked for
  193.   * An earlier installation is checked in the destination directory,
  194.     so you can change your setup by running the installation script
  195.     again
  196.   * The AmiTCP/IP files are copied to the destination if needed
  197.   * Included Sana-II device drivers are installed
  198.   * Example configuration files for the SANA-II drivers are copied to
  199.     ENVARC:sana2/ 
  200.   * EmacsTCP is installed 
  201.   * NapsaTerm is installed
  202.   * User and group databases are installed. They are useful when
  203.     dealing with Unix or multiuser filesystems.
  204.   * You are queried some information concerning your network setup:
  205.     * Your host and domain name name is stored to the environment
  206.       variable HOSTNAME
  207.     * You are asked for aliases (nicknames) for your host
  208.     * You are asked for the name, unit of the interface you are using
  209.     * Likewise the interface (and destination) IP addresses and
  210.       netmask are asked
  211.     * You are asked for the IP address of the default gateway
  212.     * You are asked for domain names and domain name server IP
  213.       addresses
  214.   * If you select to start AmiTCP/IP when your computer boots,
  215.     appropriate command is added to your s:user-startup.
  216.   * S:user-startup is modified to make right assigns and paths.
  217.   * Installer creates Amitcp:bin/startnet, a script to start
  218.     AmiTCP/IP, configure Sana-II interfaces and provide basic routing
  219.   * Other network information is saved in the file
  220.     AmiTCP:db/netdb-myhost
  221.  
  222. EOF
  223.